home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2003 August / MW 8 2003 CD1.iso / Inside Macworld / Product News / gimp-1.2.4.sit / gimp-1.2.4 / devel-docs / libgimp / tmpl / gimpfileselection.sgml < prev    next >
Encoding:
SGML Document  |  2003-05-20  |  1.7 KB  |  86 lines
  1. <!-- ##### SECTION Title ##### -->
  2. GimpFileSelection
  3.  
  4. <!-- ##### SECTION Short_Description ##### -->
  5. Widget for entering a filename.
  6.  
  7. <!-- ##### SECTION Long_Description ##### -->
  8. <para>
  9. This widget is used to enter filenames or directories.
  10. </para>
  11. <para>
  12. There is a #GtkEntry for entering the filename manually and a "..."
  13. button which will pop up a #GtkFileSelection dialog.
  14. </para>
  15. <para>
  16. You can restrict the #GimpFileSelection to directories. In this case
  17. the filename listbox of the #GtkFileSelection dialog will be hidden.
  18. </para>
  19. <para>
  20. If you specify @check_valid as #TRUE in gimp_file_selection_new()
  21. the entered filename will be checked for validity and a pixmap will be
  22. shown which indicates if the file exists or not.
  23. </para>
  24. <para>
  25. Whenever the user changes the filename, the "filename_changed" signal
  26. will be emitted.
  27. </para>
  28.  
  29. <!-- ##### SECTION See_Also ##### -->
  30. <para>
  31. #GimpPathEditor
  32. </para>
  33.  
  34. <!-- ##### STRUCT GimpFileSelection ##### -->
  35. <para>
  36.  
  37. </para>
  38.  
  39.  
  40. <!-- ##### MACRO GIMP_FILE_SELECTION ##### -->
  41. <para>
  42. Checks if the passed pointer is a pointer to a #GimpFileSelection and
  43. performs the cast if valid.
  44. </para>
  45.  
  46. @obj: The pointer to cast.
  47.  
  48.  
  49. <!-- ##### FUNCTION gimp_file_selection_new ##### -->
  50. <para>
  51.  
  52. </para>
  53.  
  54. @title: 
  55. @filename: 
  56. @dir_only: 
  57. @check_valid: 
  58. @Returns: 
  59.  
  60.  
  61. <!-- ##### FUNCTION gimp_file_selection_get_filename ##### -->
  62. <para>
  63.  
  64. </para>
  65.  
  66. @gfs: 
  67. @Returns: 
  68.  
  69.  
  70. <!-- ##### FUNCTION gimp_file_selection_set_filename ##### -->
  71. <para>
  72.  
  73. </para>
  74.  
  75. @gfs: 
  76. @filename: 
  77.  
  78.  
  79. <!-- ##### SIGNAL GimpFileSelection::filename-changed ##### -->
  80. <para>
  81. This signal is emitted whenever the user changes the filename.
  82. </para>
  83.  
  84. @gimpfileselection: the object which received the signal.
  85.  
  86.